---
title: 使用 Docker 部署
sidebarTitle: 使用 Docker 部署
---

<Note>
  **前期准备**:
  在开始之前，你至少需要有一个小智硬件设备，并已添加至小智官方服务端。并且已准备好
  Docker 环境
</Note>

## 安装方式

### 方式一：使用启动脚本（推荐）

<Note>
  如果你的网络环境无法访问 github ，可以使用 gitee 进行安装
</Note>
<CodeGroup>
  ```bash github
  # 下载脚本
  curl -fsSL https://raw.githubusercontent.com/shenjingnan/xiaozhi-client/main/docker-start.sh | bash
  ```

```bash gitee
curl -fsSL https://gitee.com/shenjingnan/xiaozhi-client/raw/main/docker-start.sh | bash
```

</CodeGroup>

### 方式二：使用 Docker Compose

<Steps>
  <Step title="获取 docker-compose.yml">
    <CodeGroup>
      ```bash github
      curl -O https://raw.githubusercontent.com/shenjingnan/xiaozhi-client/main/docker-compose.yml
      ```

      ```bash gitee
      curl -O https://gitee.com/shenjingnan/xiaozhi-client/raw/main/docker-compose.yml
      ```
    </CodeGroup>

  </Step>

  <Step title="启动服务">
    <CodeGroup>
    ```bash
    docker-compose up -d
    ```
    </CodeGroup>
  </Step>
</Steps>

### 方式三：手动启动

<Steps>
  <Step title="创建挂载点目录">
    <CodeGroup>
      ```bash macos / linux
      mkdir -p ~/xiaozhi-client
      ```
    </CodeGroup>
  </Step>

  <Step title="拉取镜像并启动服务">
    <CodeGroup>
    ```bash
    docker run -d \
    --name xiaozhi-client \
    -p 9999:9999 \
    -v ~/xiaozhi-client:/workspaces \
    --restart unless-stopped \
    shenjingnan/xiaozhi-client
    ```
    </CodeGroup>
  </Step>
</Steps>

## 管理接入点

<Note>
  在启动容器服务之后，我们需要配置小智接入点，才可以正常使用
</Note>

<Steps>
  <Step title="打开管理界面">
    如果你的容器和你的本机在一起，可以直接使用浏览器打开网址：http://localhost:9999
    如果你是在单独的设备部署容器，请确保你的电脑和单独的容器设备在同一个局域网，然后打开对应IP地址：http://{容器IP}:9999
  </Step>

  <Step title="配置小智接入点">
    TODO
  </Step>
  <Step title="重启服务">
    TODO
  </Step>
</Steps>
